home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus 1997 #1 / Amiga Plus CD - 1997 - No. 01.iso / pd / sonstiges / amiwin / x11 / man / xset.man < prev    next >
Text File  |  1985-03-23  |  10KB  |  265 lines
  1.  
  2.  
  3.  
  4. XSET(1)                  USER COMMANDS                    XSET(1)
  5.  
  6.  
  7.  
  8. NAME
  9.      xset - user preference utility for X
  10.  
  11. SYNOPSIS
  12.      xset [-display display] [-b] [b on/off]  [b  [volume  [pitch
  13.      [duration]]]  [[-]bc] [-c] [c on/off] [c [volume]] [[-+]fp[-
  14.      +=] path[,path[,...]]]  [fp  default]  [fp  rehash]  [[-]led
  15.      [integer]]  [led  on/off]  [m[ouse]  [accel_mult[/accel_div]
  16.      [threshold]]] [m[ouse] default] [p pixel color] [[-]r  [key-
  17.      code]] [r on/off] [s [length [period]]] [s blank/noblank] [s
  18.      expose/noexpose] [s on/off]  [s  default]  [s  activate]  [s
  19.      reset] [q]
  20.  
  21. DESCRIPTION
  22.      This program is used to set various user preference  options
  23.      of the display.
  24.  
  25. OPTIONS
  26.      -display display
  27.              This option specifies the server to use; see X(1).
  28.  
  29.      b       The b option controls bell volume, pitch  and  dura-
  30.              tion.   This  option  accepts  up to three numerical
  31.              parameters, a preceding dash(-), or a 'on/off' flag.
  32.              If  no  parameters  are  given,  or the 'on' flag is
  33.              used, the system defaults will be used.  If the dash
  34.              or 'off' are given, the bell will be turned off.  If
  35.              only one numerical  parameter  is  given,  the  bell
  36.              volume will be set to that value, as a percentage of
  37.              its maximum.  Likewise, the second numerical parame-
  38.              ter  specifies  the  bell  pitch,  in hertz, and the
  39.              third numerical parameter specifies the duration  in
  40.              milliseconds.   Note  that not all hardware can vary
  41.              the bell characteristics.  The X server will set the
  42.              characteristics  of the bell as closely as it can to
  43.              the user's specifications.
  44.  
  45.      bc      The bc option controls bug compatibility mode in the
  46.              server,  if  possible;  a preceding dash(-) disables
  47.              the mode, otherwise the mode  is  enabled.   Various
  48.              pre-R4  clients pass illegal values in some protocol
  49.              requests, and pre-R4 servers did not correctly  gen-
  50.              erate errors in these cases.  Such clients, when run
  51.              against an R4 server, will terminate  abnormally  or
  52.              otherwise  fail  to operate correctly.  Bug compati-
  53.              bility mode  explicitly  reintroduces  certain  bugs
  54.              into  the  X  server,  so that many such clients can
  55.              still be run.  This mode should be used  with  care;
  56.              new application development should be done with this
  57.              mode disabled.  The server  must  support  the  MIT-
  58.              SUNDRY-NONSTANDARD  protocol  extension in order for
  59.              this option to work.
  60.  
  61.  
  62.  
  63. X Version 11         Last change: Release 6                     1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. XSET(1)                  USER COMMANDS                    XSET(1)
  71.  
  72.  
  73.  
  74.      c       The c option controls key click.   This  option  can
  75.              take  an  optional value, a preceding dash(-), or an
  76.              'on/off' flag.  If no parameter or the 'on' flag  is
  77.              given, the system defaults will be used. If the dash
  78.              or 'off' flag is used, keyclick  will  be  disabled.
  79.              If  a  value  from  0 to 100 is given, it is used to
  80.              indicate volume, as a  percentage  of  the  maximum.
  81.              The  X  server  will  set  the volume to the nearest
  82.              value that the hardware can support.
  83.  
  84.      fp= path,...
  85.              The fp= sets the font path to the entries  given  in
  86.              the  path  argument.  The entries are interpreted by
  87.              the server, not by the client.  Typically  they  are
  88.              directory  names  or  font  server  names,  but  the
  89.              interpretation is server-dependent.
  90.  
  91.      fp default
  92.              The default argument causes  the  font  path  to  be
  93.              reset to the server's default.
  94.  
  95.      fp rehash
  96.              The rehash argument resets  the  font  path  to  its
  97.              current value, causing the server to reread the font
  98.              databases in the current font path.   This  is  gen-
  99.              erally  only  used  when  adding new fonts to a font
  100.              directory (after running mkfontdir to  recreate  the
  101.              font database).
  102.  
  103.      -fp or fp-
  104.              The -fp and fp- options  remove  elements  from  the
  105.              current  font  path.   They  must  be  followed by a
  106.              comma-separated list of entries.
  107.  
  108.      +fp or fp+
  109.              This +fp and fp+ options prepend and append elements
  110.              to  the  current font path, respectively.  They must
  111.              be followed by a comma-separated list of entries.
  112.  
  113.      led     The led option controls  the  keyboard  LEDs.   This
  114.              controls  the turning on or off of one or all of the
  115.              LEDs.  It accepts an optional integer,  a  preceding
  116.              dash(-) or an 'on/off' flag.  If no parameter or the
  117.              'on' flag is given, all LEDs are turned  on.   If  a
  118.              preceding  dash or the flag 'off' is given, all LEDs
  119.              are turned off.  If a value  between  1  and  32  is
  120.              given,  that  LED will be turned on or off depending
  121.              on the existence of a preceding dash.  A common  LED
  122.              which  can  be  controlled is the ``Caps Lock'' LED.
  123.              ``xset led 3'' would turn led #3  on.   ``xset  -led
  124.              3''  would  turn  it off.  The particular LED values
  125.              may refer to different LEDs on different hardware.
  126.  
  127.  
  128.  
  129. X Version 11         Last change: Release 6                     2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. XSET(1)                  USER COMMANDS                    XSET(1)
  137.  
  138.  
  139.  
  140.      m       The m option controls  the  mouse  parameters.   The
  141.              parameters  for  the  mouse  are  `acceleration' and
  142.              `threshold'.  The acceleration can be  specified  as
  143.              an  integer, or as a simple fraction.  The mouse, or
  144.              whatever pointer the machine is connected  to,  will
  145.              go `acceleration' times as fast when it travels more
  146.              than `threshold' pixels in a short time.  This  way,
  147.              the  mouse can be used for precise alignment when it
  148.              is moved slowly, yet it can be set to travel  across
  149.              the  screen  in  a  flick of the wrist when desired.
  150.              One or both parameters for the m option can be omit-
  151.              ted,  but  if  only  one is given, it will be inter-
  152.              preted as the acceleration.  If no parameters or the
  153.              flag  'default' is used, the system defaults will be
  154.              set.
  155.  
  156.      p       The p  option  controls  pixel  color  values.   The
  157.              parameters   are  the  color  map  entry  number  in
  158.              decimal, and a color specification.  The root  back-
  159.              ground  colors  may  be  changed  on some servers by
  160.              altering the entries for BlackPixel and  WhitePixel.
  161.              Although  these are often 0 and 1, they need not be.
  162.              Also, a server may choose to allocate  those  colors
  163.              privately, in which case an error will be generated.
  164.              The map entry must not be a read-only color,  or  an
  165.              error will result.
  166.  
  167.      r       The r option controls the autorepeat.  If a  preced-
  168.              ing  dash or the 'off' flag is used, autorepeat will
  169.              be disabled.  If no parameters or the 'on'  flag  is
  170.              used,  autorepeat  will  be  enabled.  If a specific
  171.              keycode is specified as a parameter, autorepeat  for
  172.              that keycode is enabled or disabled.
  173.  
  174.      s       The s option lets you set the screen  saver  parame-
  175.              ters.   This  option  accepts  up  to  two numerical
  176.              parameters,    a    'blank/noblank'     flag,     an
  177.              'expose/noexpose'   flag,   an   'on/off'  flag,  an
  178.              'activate/reset' flag, or the 'default' flag.  If no
  179.              parameters or the 'default' flag is used, the system
  180.              will be set to its default screen saver characteris-
  181.              tics.   The  'on/off'  flags  simply turn the screen
  182.              saver functions on  or  off.   The  'activate'  flag
  183.              forces activation of screen saver even if the screen
  184.              saver had been turned off.  The 'reset' flag  forces
  185.              deactivation  of  screen saver if it is active.  The
  186.              'blank' flag sets the preference to blank the  video
  187.              (if  the  hardware  can do so) rather than display a
  188.              background pattern, while 'noblank' sets the prefer-
  189.              ence  to  display  a  pattern  rather than blank the
  190.              video.  The 'expose' flag  sets  the  preference  to
  191.              allow   window  exposures  (the  server  can  freely
  192.  
  193.  
  194.  
  195. X Version 11         Last change: Release 6                     3
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. XSET(1)                  USER COMMANDS                    XSET(1)
  203.  
  204.  
  205.  
  206.              discard window contents), while 'noexpose' sets  the
  207.              preference to disable screen saver unless the server
  208.              can regenerate the screens without causing  exposure
  209.              events.   The  length  and period parameters for the
  210.              screen saver function determines how long the server
  211.              must  be inactive for screen saving to activate, and
  212.              the period to change the background pattern to avoid
  213.              burn  in.   The  arguments are specified in seconds.
  214.              If only one numerical parameter is given, it will be
  215.              used for the length.
  216.  
  217.      q       The q option gives you information  on  the  current
  218.              settings.
  219.  
  220.      These settings will be reset to default values when you  log
  221.      out.
  222.  
  223.      Note that not all X implementations are guaranteed to  honor
  224.      all of these options.
  225.  
  226. SEE ALSO
  227.      X(1), Xserver(1), xmodmap(1), xrdb(1), xsetroot(1)
  228.  
  229. AUTHOR
  230.      Bob Scheifler, MIT Laboratory for Computer Science
  231.      David Krikorian, MIT Project Athena (X11 version)
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261. X Version 11         Last change: Release 6                     4
  262.  
  263.  
  264.  
  265.